ZPlay.SetEchoParam Method

Set and change echo effect parameters.

public bool SetEchoParam(ref TEchoEffect[] EchoEffectArray, int NumberOfEffects);

Parameters

Parameters	Description
ref TEchoEffect[] EchoEffectArray	Reference to array of TEchoEffect structures specifying echo effects.
int NumberOfEffects	Number of echo effects in EchoEffectArray array.

Return Values

Return Values	Description
True	All OK.
False	Error. To get error message read here.

Description

Remarks

To produce echo effect, original samples are combined with delayed samples. You need to specify delay (in milliseconds) and volume of original samples and delayed samples.

To specify one echo effect, fill TEchoEffect with valid data. To specify multiple, complex echo effects, specify array of TEchoEffects. Output sound is combination of original samples and delayed samples.

Note: If you specify multiple delay effects, make note about volume because all effects will combine original samples with delayed samples for each effect and you will have summary of all samples.

For example: first effect is using 60 % volume of original(not delayed) samples and on these samples are added 20 % volume delayed samples. Second effect is using 0 % volume of original samples and 20 % volume of delayed samples. And resulting samples from first effect are added to resulting samples from second effect. If you use too much percent of volume, you can get overflow of sample amplitude and sound distorsions.

Note: There is no limit on number of echo effects.

Note: By default, new created interface has programmed one simple echo effect, 1000 ms delay, 70 % original volume + 30 % echo volume.

See Also

GetEchoParam, EnableEcho

Example

TEchoEffect[] effect = new TEchoEffect[2];

effect[0].nLeftDelay = 2000;
effect[0].nLeftSrcVolume = 50;
effect[0].nLeftEchoVolume = 30;
effect[0].nRightDelay = 2000;
effect[0].nRightSrcVolume = 50;
effect[0].nRightEchoVolume = 30;

effect[1].nLeftDelay = 30;
effect[1].nLeftSrcVolume = 50;
effect[1].nLeftEchoVolume = 30;
effect[1].nRightDelay = 30;
effect[1].nRightSrcVolume = 50;
effect[1].nRightEchoVolume = 30;

player.SetEchoParam(ref effect, 2);

Group

ZPlay Methods

Web: http://libzplay.sourceforge.net/

Email: zcindori@inet.hr

Made with Doc-O-Matic® Express